Article Split Groups

Frequency:

Article split group master data changes are required to be sent in near real-time. Any change to an interface field in the external system should trigger the interface.

Expected data:

Article split group data.

Technical:

If an article split group record does not exist in DSWMS, the record will be created.

If an article split group record already exists in DSWMS, the existing record will be updated with the new data.

---

POST https://{url}/v1/articles/splitgroups

Create or update article split groups.

Request Body

The request body is a JSON array of objects. Each object contains an article_id and a split_groups array with the split group details.

Top-level object:

Name	Type	Required	Description
article_id	string	Yes	Article unique identifier in ERP
split_groups	array	Yes	Array of split group objects for the article

Split group object (inside split_groups array):

Name	Type	Required	Description
split_group_id	string	Yes	Split group unique identifier in ERP
plant_id	string	Yes	Plant unique identifier in ERP
article_type_id	integer	Yes	Article type within the split group: 1 - Stock article, 2 - JIT article, 3 - Transport unit

Request Example

[
    {
        "article_id": "0001",
        "split_groups": [
            {
                "split_group_id": "1015",
                "plant_id": "102849",
                "article_type_id": 1
            },
            {
                "split_group_id": "1025",
                "plant_id": "199523",
                "article_type_id": 1
            }
        ]
    },
    {
        "article_id": "0047",
        "split_groups": [
            {
                "split_group_id": "1015",
                "plant_id": "102849",
                "article_type_id": 1
            }
        ]
    }
]

Request example (delete all split groups from a single article):

[
    {
        "article_id": "0001",
        "split_groups": []
    }
]

Response

200: OK — Success

{
    "success": true,
    "message": null
}

400: Bad Request — Error

{
    "success": false,
    "message": "Article Split Group update failed",
    "errors": [
        {
            "article_id": "0001",
            "error": "some error"
        }
    ]
}